Contacts XML export and import

For the exchange between 2 ingenious.V12 databases, contact data records including linked information such as additional addresses, project-related texts, special prices, documents & appointments, file attachments, user fields and links to contact folders can be exported and imported in XML format.

Export

The API Tool_XML_Export_Contacts can be started with 2 optional variables:

vbSelectOrder

:=True	The selection of the contacts to be exported is determined from the contact list. To do this, the script must be run from a contact list.
:=False	The selection of the contacts to be exported must be defined in the script.

vsExportPath

:=""	When exporting, the user is asked to select the export directory manually
#""	Specification of the target directory for the export

1. Export of manually selected contacts

Export of manually selected contacts	Copy Code
vbSelectOrder:=True vsExportPath:="D:"+<>PathSep+"Contact-Interface"+<>PathSep Tool_XML_Export_Contacts sys_ShellExecute ("open";vsExportPath;"";"";SW_SHOWNORMAL)

To export the contacts from the contact list, the script must be created as a saved script and assigned to the contact list.

Script assignment for contacts XML export

In the contact list all required data records are to be marked for the export and the export can be started via the entry (according to the name under which the script was created) "XML_Contact_Export".

Selection of the contacts to be exported

The export folder is then opened in accordance with the call "sys_ShellExecute (" open "; vsExportPath;" ";" "; SW_SHOWNORMAL)". The exported data records were created.

Exported contacts records

2. Export contacts via script search

The contacts XML export can alternatively be started directly in the script module. Here you must explicitly specify which contacts are to be exported.

Contact export via script search	Copy Code
vbSelectOrder:=False QUERY([Kontakte];[Kontakte]Matchcode="@muster@") vsExportPath:="D:"+<>PathSep+"Contact-Interface2"+<>PathSep Tool_XML_Export_Contacts sys_ShellExecute ("open";vsExportPath;"";"";SW_SHOWNORMAL)

Contact export via script search

Copy Code

vbSelectOrder:=False
QUERY([Kontakte];[Kontakte]Matchcode="@muster@")
vsExportPath:="D:"+<>PathSep+"Contact-Interface2"+<>PathSep
Tool_XML_Export_Contacts
sys_ShellExecute ("open";vsExportPath;"";"";SW_SHOWNORMAL)

Script for direct export of contacts

The exported data records are written to the specified folder.

Exported records

XML of an exported data record

Import

The import of the contact data records is carried out via the API Tool_XML_Import_Contacts. The following optional variables are available:

vsImportPath

:=""	The user is asked to manually select the import directory during the import.
#""	Specification of the source directory in the script

vsImportDonePath

:=""	Files already imported are not moved.
#""	Successfully imported files are moved to the specified directory. This enables more precise monitoring of the import.

Script for importing contacts	Copy Code
vsImportPath:="D:"+<>PathSep+"Contact-Interface2"+<>PathSep vsImportDonePath:="D:"+<>PathSep+"Contact-Interface"+<>PathSep+"Imported"+<>PathSep Tool_XML_Import_Contacts

Import of contact records